API Pública
Integre o MakePro ao seu fluxo
A API pública permite ler e, em domínios selecionados, registrar dados do projeto com segurança — documentos, pastas, tópicos BCF, cronograma, reuniões e diretrizes.
Autenticação
Chave de API no header Authorization. A chave age como o usuário que a emitiu.
Como obter a chave →Primeiros passos
Comece listando empresas e projetos antes de acessar documentos, pastas ou cronograma.
Ver fluxo recomendado →Referência viva
O Swagger e o OpenAPI refletem os endpoints liberados nesta instalação, hoje.
Explorar no Swagger →O que é a MakePro Works API
A MakePro Works API é a superfície HTTP para integrações externas — ERPs, dashboards, automações, scripts internos ou assistentes de IA conectados por código.
Ela é separada da API interna do sistema (api.makepro.com.br). Aqui você usa uma chave de API (mkp_...) e acessa apenas o que os scopes da chave e o RBAC do usuário permitem.
Quando usar
| Cenário | Use a API pública |
|---|---|
| Extrair lista de documentos para um BI | Sim |
| Sincronizar tópicos BCF com outro sistema | Sim |
| Registrar reunião ou pendência a partir de um formulário externo | Sim |
| Operar a interface web do MakePro | Não — use o app |
Domínios disponíveis
| Domínio | Leitura | Escrita |
|---|---|---|
| Empresas (descoberta) | Sim | — |
| Projetos | projects:read | — |
| Pastas | folders:read | — |
| Documentos (GED) | documents:read | documents:write (classificação) |
| Tópicos BCF | topics:read | — |
| Cronograma | schedule:read | — |
| Reuniões | meetings:read | meetings:write |
| Diretrizes técnicas | guidelines:read | guidelines:write |
O Swagger e o OpenAPI JSON são gerados a partir dos endpoints liberados na instalação. Em caso de dúvida sobre parâmetros ou rotas, eles são a fonte da verdade.
Próximos passos
- Primeiros passos — fluxo recomendado da primeira chamada
- Autenticação e chaves — como emitir e escopar a chave
- Referência técnica — links para Swagger, OpenAPI e convenções
- Explorar no Swagger — link para a referência interativa oficial